Microsoft DirectX 8.1 (C++)

ICARequest Object

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The ICARequest object represents an attempt by the user to access a service. When the user tunes to a channel, a tune request is generated in the form of an ITuneRequest object. The Conditional Access (CA) Manager creates an ICARequest object to encapsulate the tune request. The CA Manager has a maximum of one active request at a time.

A request can have one or more components, which represent different streams within the same request. Components include audio streams, video streams, and auxiliary data streams. To retrieve the components in a request, retrieve the ICARequest.Components property. For more information about components, see ICAComponent.

Property Description
CAManager Retrieves the controlling CA Manager.
Check Retrieves the number of components in this request that have at least one non-transient denial.
Components Queries all of the existing policies for denials.
CountDeniedComponents Retrieves the components of the request.
Denials Retrieves the denials that apply to this request, if any.
RequestedItem Retrieves the object that represents the requested service; for example, a tune request.
ResolveDenials Attempts to resolve the denials associated with this request.
ScheduleEntry Retrieves the schedule entry that corresponds to this request.

Event Description
CheckComplete Called when all of the existing policies have checked a request.
CheckStarted Called immediately before all of the policies check a request.